home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Special 18 / AMIGAplus Sonderheft 18 (1999)(ICP)(DE)[!].iso / PD / Anwendungen / FS1541-13 / FS1541.DOC < prev    next >
Text File  |  1999-01-03  |  8KB  |  204 lines
  1.  
  2. ===========================================================================
  3.                                 FS1541 v1.3
  4. ===========================================================================
  5.  
  6.           (C) Copyright 1996-1999 by Michael Krause.
  7.            For license see the file COPYING
  8.  
  9. ===========================================================================
  10.  
  11.  
  12. ---------------------------------------------------------------------------
  13. >>> INTRODUCTION
  14. ---------------------------------------------------------------------------
  15.  
  16. Forget all those nasty tools to read files from 1541 disks:
  17.  
  18. FS1541 is a full-blown AmigaDOS file system, which reads and writes
  19. the CBM 1541 disk format.  The CBM 1541 floppy drive has been the
  20. standard disk drive for the C64 computer series, and many people still
  21. have disks flying around.  In order to process disks directly, you
  22. need the >Catweasel< floppy disk controller and a 5.25 inch drive.
  23.  
  24. The Catweasel (available from Vesalia Germany), which includes this
  25. file system, lets you use standard PC disk drives to read and write PC
  26. and Amiga DD/HD disks at a much higher speed than provided by the
  27. Amiga custom chips.  When used with a 5.25 inch disk drive, you can
  28. use this file system to process 1541 disks directly.
  29.  
  30. If you don't have a Catweasel, you'll have to use "fmsdisk.device"
  31. from Aminet or somewhere, which lets you operate on ".d64" disk image
  32. files.
  33.  
  34. You can get more information about the Catweasel from:
  35. - the author himself, Jens Schönfeld <sysop@nostlgic.tng.oche.de>
  36. - http://members.tripod.com/~apd2/catweasl.htm
  37.  
  38.  
  39. ---------------------------------------------------------------------------
  40. >>> INSTALLATION
  41. ---------------------------------------------------------------------------
  42.  
  43. There  are  two  versions of 1541-handler, one for plain 68000 machines and
  44. one  optimized  for  the  68030  processor (which will also work fine on an
  45. 68020).   Copy  the  respective  file  to  "L:1541-handler".   Then add the
  46. following lines to "DEVS:MountList":
  47.  
  48. CBM0:
  49.         Handler = L:1541-handler
  50.         Stacksize = 4096
  51.         Priority = 10
  52.         GlobVec  = -1
  53.         Mount = 1
  54.         Startup = "DEVICE multidisk.device UNIT 1"
  55. #
  56.  
  57. Explanation of options:
  58.  
  59.         D=DEVICE/A      Name of a trackdisk.device compatible device.
  60.                         Supported and tested are "multidisk.device" and
  61.                         "fmsdisk.device".
  62.  
  63.         U=UNIT/N/A      Exec device unit. 0 or 1 for "multidisk.device",
  64.                         see docs for "fmsdisk.device".
  65.  
  66.         F=FLAGS/N       Exec device flags. Defaults to 16 for multidisk.
  67.  
  68.         NS=NOAUTOSCAN/S Don't read complete disk after insertion.
  69.  
  70.         I=INTERLEAVE/N  Sector interleave when writing data. Defaults to 4.
  71.  
  72.         ICON/K          Followed by the complete pathname of an alternative
  73.                         file used as Disk.info. There are two icons in this
  74.                         archive, the ugly one painted by me is included in
  75.                         the executable as the default icon.
  76.  
  77.  
  78. ---------------------------------------------------------------------------
  79. >>> USAGE
  80. ---------------------------------------------------------------------------
  81.  
  82. Issue  the  command  `mount  cbm0:', and insert disks.  Write support works
  83. okay  as  long as the BAM is not corrupt.  Unfortunately, this version does
  84. not  feature  a  disk  validator,  but  I  will  add  that.   You  need the
  85. multidisk.device   2.0   to  be  able  to  write  and  format  disks  (with
  86. fmsdisk.device it's no problem, of course).
  87.  
  88. There  are  four  so-called  "virtual"  files,  which  don't  appear in the
  89. directory and serve special purposes:
  90.  
  91.         $               Contains an ANSIfied directory as it would be given
  92.                         by a C64/1541 with LOAD "$",8 and LIST.
  93.  
  94.         $d64            Access the .d64 file corresponding to the current
  95.                         disk. E.g. you can use `copy cbm0:$d64 ram:dsk.d64'
  96.                         to create .d64 images of your disks very easily!
  97.                         You can also write to this file and modify the disk
  98.                         directly in a file monitor. After modifying I
  99.                         suggest you issue a 'diskchange' command.
  100.  
  101.         $opt            If you access this file in any way, e.g. by means
  102.                         of type or delete, the directory is optimized: All
  103.                         (invisible and visible) DEL entries are thrown out.
  104.                         You must know that files are not deleted completely
  105.                         with "delete", but rather set to DEL instead.
  106.                         This operation discards those directory entries.
  107.  
  108.         Disk.info       Provides a disk icon for Workbench. See `ICON'
  109.                         startup option.
  110.  
  111. The  last  file  can be overridden, i.e.  you can create a real file called
  112. `Disk.info'  on the disk which will be visible then.  If you delete it, the
  113. virtual file will become active again.
  114.  
  115. When  formatting  disks,  the  system  is told the disk consists of one big
  116. cylinder.  This is due to the variable track layout on a 1541 disk!
  117.  
  118.  
  119. ---------------------------------------------------------------------------
  120. >>> HISTORY
  121. ---------------------------------------------------------------------------
  122.  
  123. V1.3 (01-Jan-99) (most changes by John "Graham" Selck)
  124. - Improved error handling. Finally retries on errors are done.
  125. - BAM handling is more secure now.
  126. - Slightly adjusted block allocation algorithm
  127. - Support for illegal directory filetypes
  128. - Some minor bug fixes.
  129.  
  130. v1.2 (29-May-97)
  131. - Fixed possible crash when mounting the device from DEVS:DOSDrivers,
  132.   before the Workbench is started.
  133. - Included disk icon from Thomas Broß and the ICON startup option.
  134.  
  135. v1.1 (19-Feb-97)
  136. - Bug fixed in handling of unformatted disks.
  137. - German translation of TFM
  138.  
  139. v1.0 (20-Jan-97)
  140. - You can rename files and disks now!
  141. - Writing many small files is faster, since the BAM update is done only
  142.   once: one second after the last access, just like the ROM FileSystem
  143.   does it.
  144. - Removed bug in ACTION_PARENT
  145.  
  146. v0.7 (15-Dec-96)
  147. - Block allocation assumed a wrong BAM structure, now fixed.
  148. - Virtual file '$opt'
  149. - Formatting
  150. - Everything works fine with the new multidisk.device 2.0!
  151.  
  152. v0.6 (08-Dec-96)
  153. - You can write files now!
  154. - Virtual file '$'
  155. - Some small bugs fixed
  156.  
  157. v0.5 (24-Nov-96)
  158. - First public release
  159.  
  160. A detailed list of changes can be found in file "ChangeLog".
  161.  
  162.  
  163. Thanks  must  go  to  John Selck (Graham/Oxyron) for his numerous hints and
  164. tips  to  the structure of 1541 disks.  My documents contained many errors!
  165. Without him this FileSystem wouldn't be so stable.
  166.  
  167.  
  168. ---------------------------------------------------------------------------
  169. >>> FUTURE
  170. ---------------------------------------------------------------------------
  171.  
  172. - Virtual file $val, which can be used to validate disks.
  173. - ACTION_SET_FILE_SIZE
  174. - Linux port (as soon as I've figured out how the kernel works...)
  175.  
  176.  
  177. ---------------------------------------------------------------------------
  178. >>> WHAT ABOUT THE SOURCE CODE?
  179. ---------------------------------------------------------------------------
  180.  
  181. FS1541  was  entirely  written  using  GCC 2.7.2.1 from the ADE as found on
  182. ftp.ninemoons.com or the Geek Gadgets 1 CD.  The source code is IMHO a good
  183. example of how AmigaDOS handlers work.
  184.  
  185.  
  186. ---------------------------------------------------------------------------
  187. >>> WHERE TO FIND THE AUTHOR:
  188. ---------------------------------------------------------------------------
  189.  
  190. Michael Krause
  191.  
  192. m.krause@tu-harburg.de
  193. rawstyle@ms.demo.org
  194.  
  195. http://www.tu-harburg.de/~semk2104/
  196.  
  197.  
  198. ---------------------------------------------------------------------------
  199. >>> LEGAL MUSH!
  200. ---------------------------------------------------------------------------
  201.  
  202. This program has been released under the GNU General Public License,
  203. see the file COPYING and the source headers for details.
  204.